package org.lcc.Service;

import org.springframework.core.io.Resource;

import java.util.Map;

/**
 * 证书服务接口
 */
public interface CertificateService {

    /**
     * 获取证书PDF资源
     * @param certificateCode 证书编码
     * @return PDF资源
     */
    Resource getCertificatePdf(String certificateCode);

    /**
     * 验证证书有效性
     * @param certificateCode 证书编码
     * @return 是否有效
     */
    boolean verifyCertificate(String certificateCode);

    /**
     * 获取学生证书列表
     *
     * @param studentId 学生ID
     * @param pageNum   页码
     * @param pageSize  每页大小
     * @param keyword   搜索关键词
     * @return 分页结果，包含列表数据和分页信息
     */
    Map<String, Object> getStudentCertificates(String studentId, Integer pageNum, Integer pageSize, String keyword);
} 